home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / comms / internet / html-related / hsc / example / readme next >
Text File  |  1996-09-09  |  2KB  |  65 lines
  1. Example Project
  2. ===============
  3.  
  4. This directory contains a small example project.
  5.  
  6. The sources are collected in "source_hsc/" and should be converted to
  7. "object_html/". This is the directory where the "browsable" data
  8. will be located.
  9.  
  10. This text asumes that your current directory is
  11. "[hsc]/example/source_hsc/".
  12.  
  13. Description of sources:
  14. -----------------------
  15.  
  16. main.hsc              the project's intros page
  17. stupid.hsc            a simple page that can be reached from "main"
  18. macro.hsc             contains some macro definitions and is
  19.                       included into all files
  20. hugo/                 a subdirectory, where all information about
  21.                       Hugo is collected
  22. hugo/hugo.hsc         some information about Hugo
  23. hugo/hugo.gif         a picture of Hugo
  24.  
  25. Setting up the object directory:
  26. --------------------------------
  27.  
  28. For every directory in the source-dir, a corresponding directory
  29. with the same name has to be created. This can be done via
  30.  
  31.     makedir /object_html/hugo                    ; AmigaOS
  32.     mkdir   ../object_html/hugo                  ; Unix
  33.  
  34. As the picture is of no real use in the source-dir, you should move
  35. it to the object-dir:
  36.  
  37.     rename hugo/hugo.gif /object_html/hugo/      ; AmigaOS
  38.     mv hugo/hugo.gif ../object_html/hugo/        ; Unix
  39.  
  40. Note that every file, that is not a hsc-source or include-file has
  41. to be located somewhere in the object-dir. This especially concerns
  42. pictures, sounds and everything else that is linked, but not a
  43. hsc-source.
  44.  
  45. Starting the conversion:
  46. ------------------------
  47.  
  48. Now you are ready to start `make':
  49.  
  50.     make
  51.  
  52. Of course, you need to have a `make' command installed in your search
  53. path. For AmigaOS, search "aminet:dev/*" for fitting a program.
  54.  
  55. After that, all html-objects in "object_html/" should be ready.
  56.  
  57. Note that there does not exist a "macro.html", because the there was
  58. no rule for this in the makefile. There is no rule neccessary,
  59. because "macro.hsc" is never converted alone, but only included by
  60. the other files. Additionally, "macro.hsc" contains no readable text
  61. or tags.
  62.  
  63. Take a look at the "Makefile" to understand the basic concept of hsc.
  64.  
  65.